home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-20
/
msatcm.zip
/
MSATCOM.DOC
< prev
next >
Wrap
Text File
|
1991-09-26
|
18KB
|
484 lines
(*****************************************************************************)
(* *)
(* MSATCOM(tm) - MicroSat Ground Station Terminal *)
(* *)
(* Version 1.0 *)
(* *)
(* (c) Copyright 1990 by Claudio M. Zanella LU4AEY *)
(* Released For Public Distribution *)
(* ALL RIGHTS RESERVED *)
(* *)
(*****************************************************************************)
UTILIDAD
Terminal de comunicaciones digitales protocolo FTL0 (File Transfer Level 0)
REQUERIMIENTO DE SOFT
- MSATCOM.EXE Programa principal (versión en inglés)
- README.COM Programa para lectura del archivo THUNDER.DOC
- MSUSER.DOC Este documento
- MSATCOM.CNF Archivo de configuración del sistema
REQUERIMIENTO DE HARDWARE
MSATCOM puede ser utilizado en PC, XT, AT y Compatibles, requiere para
su funcionamiento TNCs con comandos tipo TAPR y una completa conexión
del port RS232 patas 1,2,3,4,5,6,7,8,20 (Tener especial atención en las
patas: 8 Data Carrier Detect, 4 Request to Send y 5 Clear to Send).
En PACCOMM TNC 220 - 320 setear JP-C en CONN (Default es HIGH)
Es recomendable el uso del siguiente CONFIG.SYS:
FILES = 20
BUFFERS = 20
MSATCOM fue testeado con el siguiente HARDWARE:
Tipos de TNC:
PACCOMM TINY 2
PACCOMM TNC 200
PACCOMM TNC 220
PACCOMM TNC 320
MFJ-1270/1278
AEA PK 232
AEA PK88
Tipo de computadoras:
PC AT 80386 20/25 MHz
PC AT 80286 16/20 MHz
PC AT 80286 12/16 MHz
PC XT 80286 8/12 MHz
PC XT 8088 4/10 MHz PC XT NEC V20 10/12 MHz
SETEO DEL TNC
Este programa utiliza Hardware Handshaking. Setee su TNC en NO PARIDAD
y EL LARGO DE PALABRA en 8 BITS.
CPactime OFF
CR ON
SEnd $0D
DCD ON <-- Detect Carrier Externo en PK232
Habilite el Harddware Handshaking de su TNC de la siguiente forma:
START 0
STOP 0
XFLOW OFF
XON 0
XOFF 0
Se recomienda el uso de los siguientes parámetros:
TXDEALY 20
AXDELAY 20
PRIOACK ON <-- Release TAPR 1.1.7 solamente
FLOW ON
SUMARIO DE COMANDOS
Los siguientes comandos están disponibles en MSATCOM:
F1 - Solicitar envio de Directorios.
F2 - Solicitar recepcion de archivos (DOWNLOAD).
F3 - Solicitar el envio de archivos (UPLOAD).
F4 - Activa/Desactiva la imprsora en modo Directorio.
F5 - Reveer pantalla de directorios bajados.
F6 - Ajustar tiempo de peticion de directorios Generales (ALL).
F7 - Ajustar tiempo de peticion de directorios Personales (MY).
F8 - Ajustar tiempo de peticion de directorios Boletines (BUL).
F9 - Cambio de satelite corriente.
F10 - Gateway al DOS.
Alt-B - Enviar señal de break al TNC para ponerlo en modo comando.
Alt-D - Cambiar nivel de Data Carrier Detect (DCD pin 8 v24).
Alt-H - Pantallla de Ayuda (HELP).
Alt-R - Reorganizar los archivos que contiene los directorios.
Alt-T - Modo Terminal / Modo Server.
Alt-X - Finalizar ejecución de MSATCOM (Retorno al DOS).
DESCRIPCION DEL USO DE COMANDOS
TECLA F1 (DIRECTORY):
Pulsando F1 se ingresa a las opciones de DIRECTORIO. Hay cuatro opciones
disponibles en esta modalidad:
ALL - Recibir los File Header desde la ultma solicitud.
PERSONAL - Recibir los File Header enviados a nuestra licencia desde la
ultima solicitud.
BULLETIN - Recibir los File Header enviados a ALL (TODOS) desde la ultima
solicitud.
SEARCH - Recibir los File Header que contenga el criterio de busqueda
especificado por Ud. tomando como referecia el tiempo desde la
ultima solicitud a ALL.
Para corregir los tiempos de ultima solicitud ver las opciones F6, F7 y F8
los mismos estan contenidos en los archivos MSTIME.ALL, MSTIME.MY y
MSTIME.BUL en formato UNIX Hexadecimal.
TECLA F2 (DOWNLOAD):
Por intermedio de esta tecla accedemos a la opcion DOWNLOAD (BAJAR). Su
uso es muy simple y consiste en indicar el valor HEXADECIMAL de archivo el
cual nos interesa recibir.
Este quedara memorizado hasta tanto el proceso de BAJADA haya concluido ya
sea con exito o no, es decir que si por algun motivo la BAJADA del archivo
no finalizo y el contacto con el server se pierde, en la siguiente
oportunidad bastara con pulsar nuevemte F2 y automaticamente el programa
reiniciara la operacion de BAJADA desde el offset donde perdio el contacto
ATENCION: Esto se repetira hasta tanto el programa no reciba el COMANDO
DATA END o bien el DOWNLOAD_ERR_RESP que saque del Status PDL
al archivo de BAJADA. En caso de querer abortar Ud. esto BORRE
desde su DOS el archivo de BAJADA corriente.
Status de los Archivos:
xxxxxx.PDL : Archivo en proceso de Bajada (Esta no ha finalizado).
xxxxxx.DL : Archivo ha sido bajado con exito.
xxxxxx.XDL : Archivo rechazado (Se produjo un error en la bajada).
xxxxxx : Numero Hexadecimal del Archivo requerido.
TECLA F3 (UPLOAD):
Al pulsar esta opcion se accede al UPLOAD (SUBIR) la cual nos permite el
envio de archivos en formato FT Level 0 al server del Microsatelite.
Al igual que el DOWNLOAD, la opcion UPLOAD queda memorizada hasta tanto el
proceso de SUBIDA haya concluido exitosamente o no.
Si no se logra finalizar el envio por perdida del contacto con el server
en la siguiente oportunidad podremos reiniciar el envio desde el offset
donde se haya interrumpido el proceso.
El UPLOAD en todos los casos es de acceso inmediato, es decir que una vez
pulsada esta opcion , de encontrarse archivos para enviar, el programa
inicia el procedimiento de conexion.
Status de los archivos:
mmmmmm.OUT : Archvio en proceso inicial de envio.
xxxxxx.PUL : Archivo en proceso de envio (Este se ha interrumpido).
xxxxxx.UP : Archivo ha sido subido con exito.
xxxxxx.XUL : Archivo rechazado, se produjo algun error en la subida.
mmmmmm : Nombre inicial del archivo.
xxxxxx : Numero Hexadecimal asigando por el server
TECLA F4 (PRINTER TOGGLE):
Esta opcion permite poner o sacar de linea a la impresora. La misma sera
utilizada en el proceso DIRECTORY, es decir que podremos obtener una copia
en papel del directorio del server a medida que lo estemos recibiendo, de
esta forma la operatoria de DOWNLOAD se agiliza notablemente.
TECLA F5 (RELOAD/REVIEW DIRECTORY):
La funcion de esta opcion es permitirnos cargar y sortear (Reordenar) en
memoria los directorios recibidos del server corriente, a la vez que son
mostrados en la pantalla desde el mas nuevo al mas viejo.
Por medio de las teclas PageUp y PageDwn se podra saltar por pagina entera
estos directorios. Las teclas Cursor Arriba y Cursor Abajo podremos hacer
subir o bajar por linea. La tecla Home posiciona la pantalla al comienzo
del directorio. La tecla End posiciona la pantalla al final del directorio
La tecla W permite grabar en un archivo, los directorios de pantalla.
Los mensajes dirigidos a nuestra licencia seran resaltados con el fin de
indicarnos la presencia de esta en la lista.
Un sub-proceso es ejecutado al correr esta opcion. Este consiste en cargar
en una sublista los directorios.
Este sub-proceso asegura que los File Header recibidos durante el proceso
DIRECTORY no se repitan, es decir que no se generen Directorios duplicados
Si se detecta la presencia de un Directorio duplicado, este es indicado en
pantalla, pero no es grabado en el archivo maestro.
TECLAS F6, F7, F8 (TIME ADJUSTMENT):
De estas opciones dependen los tiempos de requisito de los directorios.
MSATCOM raliza todos los pedidos de directorios tomando como referencia el
tiempo actual de los archivos MSATCOM.BUL, MSATCOM.ALL o MSATCOM.MY segun
sea el caso.
Estos archivos seran actualizados luego de haber concretado una solicitud
de directorio, para ello se toma como referencia el tiempo del ultimo File
Header en el server.
Un vez actualizado, este tiempo podra ser alterado con estas opciones, la
misma consiste en indicarle al programa la diferencia en horas de nuestra
hora GMT.
El formato de estos archivos es HEXADECIMAL y corresponde al tiempo en
UNIX.
Los mismos seran creados por primera vez por el programa, tomando como
referencia el tiempo actual del programa.
TECLA F9 (CHANGE COURRENT SATELLITE):
Esta opcion, de acceso inmediato, permite cambiar en forma instantanea el
satelite corriente del programa.
De esta forma se puede cambiar la configuracion del programa para el nuevo
satelite, sin tener que abandonarlo para realizar cambios al archivo de
configuracion, el cual hace perder tiempo y realiza mas complejo su uso.
TECLA F10 (DOS GATEWAY):
Permite realizar un shell al DOS para ejecutar comandos o programas
externos a MSATCOM.
TECLA ESC (ABORT & DISCONNECT):
Esta tecla permite abortar cualquier operacion iniciada en forma inmediata
produciendo un reseto total del estado de las variables del programa.
TECLA ALT-B (SEND BREAK):
Permite enviar una señal de ruptura de 350 ms cuando nos encontramos en el
modo terminal con el objeto de poner al TNC en modo COMANDO.
TECLA ALT-D (DCD LEVEL):
Permite cambiar el estado logico del DCD, esta opcion fue incorporada con
el fin de permitir el uso de TNC's que que usan como DCD VALIDO un estado
Alto, siendo el estado Bajo el comunmente encontrado en los TNC's.
TECLA ALT-H (HELP SCREEN):
Esta opcion nos da acceso a una pequeña ayuda en pantalla de los comandos
del programa.
TECLA ALT-R (REBUILD DIRECTORY):
Utilizada para un reorganizado del archivo directorio del satelite
corriente.
Esta reorganizacion consiste en depurar al archivo directorio de posibles
directorios duplicados a la vez borrar los viejos, posteriores a la
cantidad de dias que nosotros le indiquemos.
TECLA ALT-T (TERMINAL/SERVER MODE):
Por medio de esta opcion podremos pasar del modo SERVER al modo TERMINAL
en forma instantanea y rapida.
TECLA ALT-X (EXIT TO DOS):
Finalizar ejecución de MSATCOM (Retorno al DOS).
--- ** ---
Configuracion del archivo MSATCOM.CNF
-------------------------------------
Como vimos al comienzo, este archivo es el encargado de configurar el
sistema, el mismo esta dividido en cuatros secciones (Serial SetUP, Misc
Function, Top_Cmd_Start/End_Cmd_Setup y Top_Cmd_End/End_Cmd_Setup). La
primera y segunda estan destinadas a enviar distintos comandos al
programa propiamente dicho y las dos restantes tienen por mision enviar
comandos al TNC para setearlo en su inicio y al salir del programa,
estos ultimos pueden ser configurados por el usuario.
Configuracion Tipica
--------------------
En la primera seccion (Serial SetUP) encontramos como comienzo de la
misma el seteo de velocidad para la comunicacion de la computadora al
TNC, es necesario que ambos coincidan en esta velocidad, es decir que el
TNC en este caso debera estar seteado a 9600 Baud. El largo de palabra,
la paridad y el bit de parada deben coincidir con el seteo previo del
TNC. Tres opciones existen para el Handshake y estas son las
siguientes: H (hardware, RTS/CTS) , S (software, XON/XOFF) y N (none).
La mas aconsejada es la de Hardware.
Tambien es posible setear el puerto de comunicaciones a usar en nuestra
computadora con la opcion de Com_Port y es necesario hacerlo indicandolo
con numeracion exadecimal, agregando en el siguiente seteo (IRQ_Com) el
numero correspondiente de interrupcion, por ejemplo:
Port 1 = $03f8 IRQ4
Port 2 = $02f8 IRQ3
Port 3 = $03e8 IRQ4
Port 4 = $02e8 IRQ3
#
# MSATCOM version 1.0 -- Configuration FILE --
#
# Serial SetUP
#
#
Baud_Rate = 9600
#
Word_Lenght = 8
#
Parity = N
#
Stop_Bit = 1
#
Handshake = H
#
Com_Port = $03F8
#
IRQ_Com = 04
#
#
En la segunda seccion (Misc Function), tenemos las dos primeras
instrucciones que corresponden al tipo de placa de video que se usa,
normalmente Not y Yes son los mas usados, pero en algunos casos es
necesario cambiar Not/Yes para un mejor funcionamiento dependiendo de la
placa de video.
SYSOP_NAME: como la plabara lo dice , es necesario colocar el nombre
del operador del sistema.
MYCALL: licencia del operador.
GMT_ZONE: esta pensado para que el programa utilize la hora universal
coordinada, tomando para ello la hora de la computadora, es por ello que
debemos tener la precaucion de mantener en hora nuestra maquina y en
este caso debemos indicar si nuestra estacion se encuentra al este o al
oeste de Grenwich de la siguiente manera: EST o WES
GMT_HOURS: este comando funciona paralelamenta al anterior y es
necesario indicar la diferencia horaria que existe entre nuestro QTH y
la hora de Grenwitch siempre en numero positivo.
SATELLITE: Debera ser colocada la licencia del satelite al que deseamos
conectar, sin omitir el numero que correspondiera despues del guion y en
este caso es el numero 12, que para todos los satelites el -12
identifica al BBS durante la ejecucion del programa se puede cambiar de
satelite (F9) sin modificar la configuracion
DCD_LEVEL: Nivel logico del DCD L (bajo) o H (alto)
SORT_TYPE: Esta instruccion es usada por la opcion F6 para realizar la
clasificacion del directorio y en este caso sera realizada por tiempo
(TIME), es decir que se vera en la pantalla desde la fecha mas reciente
a la mas antigua. Tambien es posible que podamos hacer la clasificacion
por otro parametro como por ejemplo SIZE (tama#o).
# Misc Function
#
#
Snow_Check = Not
#
Direct_Video = Yes
#
#
Sysop_Name = Ruben
#
Mycall = LU6DYD
#
GMT_ZONE = EST
#
GMT_HOURS = 3
#
SATELLITE = SIMSAT-12
#
DCD_LEVEL = L
#
SORT_TYPE = TIME
#
#
En la tercera seccion tenemos la posibilidad de colocar los parametros
del TNC que creemos conveniente enviar al arrancar el programa estos
parametros seran enviados al TNC en forma automatica y pueden ser
modificados por el usuario para una mejor operacion con el satelite
*** Top_Cmd_Start
#
#
FULLD ON
FRAC 2
CONOK OFF
MAX 7
PAC 255
TXD 25
AXD 25
UN SIMSAT V SIMSAT-1
BT SIMSAT Simulador Terrestre de Micro Satelites - Buenos Aires ARGENTINA.
B E 5
M ON
CONMODE TRANS
#
*** End_Cmd_Setup
#
La cuarta seccion es identica a la tercera pero los parametros se envian
al TNC cuando salimos del programa (ALT-X) tambien estos parametros pueden
ser modificados por el usuario principalmente aquellos que utilicen el
mismo TNC para operacion en satelites y terrestre.
#
*** Top_Cmd_End
#
#
FULLD OFF
CONMODE CONVERSE
MCOM ON
UN CQ
B E 0
BT %
CONOK ON
MON OFF
#
*** End_Cmd_Setup
#
--- ** ---
REPORTE DE ERRORES:
Debido a que el programa aun se encuentre en etapa desarrollo es posible
que se puedan llegar a dar errores. Si esto asi favor preste atencion a
lo siguiente:
Algunos errores en el momento de la ejecucion hacen que el programa
visualice un mensaje de error y termine.
Run time error: nnn at xxxx:yyyy
nnn : Numero de error.
xxxx:yyyy : Direccion del error (segmento y desplazamiento).
Los errores en tiempo de corridad se dividen en cuatro tipos:
Errores de D.O.S. : Del 1 al 99.
Errores de Entrada/Salida (I/O) : Del 100 al 149.
Errores criticos : Del 150 al 199.
Errores fatales : Del 200 al 255.
Anote esta informacion y enviemela con el fin de poder evaluar y corregir
el posible error.
--------------------------------------------------------
*** ATENCION ***
Radioaficionados:
----------------
Para su distribución no se solicita ningún tipo de arancel; si Ud. es
poseedor de MSATCOM, por favor hágamelo saber a efectos de llevar una
estadística de uso, como así también cualquier tipo de error que Ud.
pueda llegar a detectar o sugerencias para su mejora.
A tal efecto remita mail via Packet Radio a:
LU4AEY @ LU4AEY.#VDP.ARG.SA Claudio M. Zanella
Por correo a:
Claudio M. Zanella
Av. Alvarez Jonte 3353 Piso 1 Dto 2 Villa del Parque
CP (ZIP) 01407 Buenos Aires - ARGENTINA. TE: 001-01-567-1239.
* * * * * * * *
Que lo disfrute!
... Claudio